Visualización de tickets protegidos

Cuando un evento o show tiene activada la funcionalidad TicketShield, los tickets deben mostrarse utilizando la interfaz segura de menta. Para garantizar la correcta protección de los tickets, es crucial adaptar todos los puntos de acceso que redirigen a los uduarios a donde los visualizan.

Proceso de TicketShield:

1. Reemplazo de Tickets: En lugar de mostrar el ticket en formato PDF o una vista estática, reemplázalo con una URL segura proporcionada por menta. Esta URL redirige a una visualización segura del ticket, que incluye un código QR bloqueado y su correspondiente estado y acciones.

2. Bloqueo y Desbloqueo: menta bloquea los códigos QR por un período determinado (por ejemplo, hasta 3 horas antes del inicio del evento). Puedes ajustar este período desde el dashboard de menta. Una vez desbloqueado, el ticket estará disponible en la interfaz de menta, y el usuario recibirá un email de notificación. Se recomienda incluir el ticket en PDF en este correo para mejorar la experiencia del usuario final.

URL de vista de los tickets

La URL de vista de los tickets en menta, deberá utilizarse en todas las instancias en las que el usuario tenga acceso a ver tickets. Estos pueden ser:

• La página de confirmación de compra;
• La sección de “Mis tickets” de su plataforma;
• Los emails de confirmación de compra; entre otros.

Para crear este enlace deben proporcionarnos cierta información de los tickets.

cURL

curl -X GET "https://api.mentatickets.com/v1/tickets/YOUR_TICKET_ID/url" \
-H "Authorization: YOUR_API_KEY"

Respuesta cURL

{
  'status': 200,
  'data': 'https://qrlink.mentatickets.com/es/...',
  'errors': None
}

Python

import requests

ticket_id = "YOUR_TICKET_ID"
url = f"https://api.mentatickets.com/v1/tickets/{ticket_id}/url"
api_key = "YOUR_API_KEY"
headers = {"Authorization": api_key}

response = requests.get(url, headers=headers)
print(response.json())

Respuesta Python

{
  'status': 200,
  'data': 'https://qrlink.mentatickets.com/es/...',
  'errors': None
}

Java

import okhttp3.*;
import java.io.IOException;

OkHttpClient client = new OkHttpClient();
String apiVersion = "v1";
String ticketId = "YOUR_TICKET_ID";
String url = "https://api.mentatickets.com/v1/tickets/" + ticketId + "/url";

Request request = new Request.Builder()
        .url(url)
        .addHeader("Authorization", "YOUR_API_KEY")
        .get()
        .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
} catch (IOException e) {
    e.printStackTrace();
}

Respuesta Java

{
  "status": 200,
  "data": "https://qrlink.mentatickets.com/es/...",
  "errors": []
}

PHP

<?php
$ticket_id = "YOUR_TICKET_ID";
$url = "https://api.mentatickets.com/v1/tickets/{$ticket_id}/url";
$api_key = "YOUR_API_KEY";
$headers = array("Authorization: {$api_key}");

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$response_data = json_decode($response, true);
print_r($response_data);
?>

Respuesta PHP

Array
(
    [status] => 200
    [data] => https://qrlink.mentatickets.com/es/...
    [errors] => Array
        (
            [0] =>
        )
)

Webhook de TicketShield activado/desactivado

El reemplazo de los tickets tradicionales por la URL de tickets de menta, se debe realizar de manera condicional en su plataforma escuchando los Webhooks de menta de TicketShield activado / TicketShield desactivado.

Ejemplo de Webhook de TicketShield activado:

curl --location 'This webhook will be sent to your platform exposed endpoint' \
--data '{
    "family": "ticketShield",
    "action": "ticketShield.updated",
    "data": {
        "status": true,
        "eventId": "YOUR_PLATFORM_EVENT_ID",
        "showId": "YOUR_PLATFORM_SHOW_ID",
    }
}'

Ejemplo de Webhook de TicketShield desactivado:

curl --location 'This webhook will be sent to your platform exposed endpoint' \
--data '{
    "family": "ticketShield",
    "action": "ticketShield.updated",
    "data": {
        "status": false,
        "eventId": "YOUR_PLATFORM_EVENT_ID",
        "showId": "YOUR_PLATFORM_SHOW_ID",
    }
}'

Ejemplo de aplicación:

Si un evento tiene TicketShield activado, la sección de “Mis tickets” de su plataforma y el correo de confirmación de compra deberían mostrar un botón que dirija a ver el QR en menta, utilizando la URL de tickets de menta.

En cambio, si el evento tiene TicketShield desactivado, la sección de “Mis tickets” de su plataforma y el correo de confirmación de compra deberían mostrar el ticket de manera original, como lo hacían previo a la integración con menta.